Media Property Functions0

This section discusses functions for setting and retrieving the property atom container of a media handler. For more information about using the sprite media handler with these functions, see "Programming with QuickTime Sprites."

GetMediaPropertyAtom

The GetMediaPropertyAtom function retrieves the property atom container of a media handler.



 
pascal OSErr GetMediaPropertyAtom (

                     Media theMedia,

                     QTAtomContainer *propertyAtom)

theMedia: Contains a reference to the media handler for this operation.
propertyAtom: Contains a pointer to a QT atom container. On return, the atom container contains the property atoms for the track associated with the media handler.

DISCUSSION

You can call the GetMediaPropertyAtom to retrieve the properties of the track associated with the specified media handler. The contents of the returned QT atom container are defined by the media handler. The caller is responsible for disposing of the QT atom container.

RESULT CODES

`memFullErr`	-108	Not enough room in heap zone
`invalidMedia`	-2008	The media is corrupted or invalid

SetMediaPropertyAtom

The SetMediaPropertyAtom function sets the property atom container of a media handler.



 
pascal OSErr SetMediaPropertyAtom (

                     Media theMedia,

                     QTAtomContainer propertyAtom)

theMedia: Contains a reference to the media handler for this operation.
propertyAtom: Specifies a QT atom container that contains the property atoms for the track associated with the media handler.

DISCUSSION

You can call the SetMediaPropertyAtom to set properties for the track associated with the specified media handler. The contents of the QT atom container are defined by the media handler.

RESULT CODES

`memFullErr`	-108	Not enough room in heap zone
`invalidMedia`	-2008	The media is corrupted or invalid